<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>启动一个 PostgreSQL 连接的追踪功能</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.pg-set-error-verbosity.html">pg_set_error_verbosity</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.pg-transaction-status.html">pg_transaction_status</a></div>
 <div class="up"><a href="ref.pgsql.html">PostgreSQL 函数</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.pg-trace" class="refentry">
   <div class="refnamediv">
    <h1 class="refname">pg_trace</h1>
    <p class="verinfo">(PHP 4 &gt;= 4.0.1, PHP 5)</p><p class="refpurpose"><span class="refname">pg_trace</span> &mdash; <span class="dc-title">启动一个 PostgreSQL 连接的追踪功能</span></p>

   </div>
   <div class="refsect1 unknown-seealsp" id="refsect1-function.pg-trace-unknown-seealsp">
    <h3 class="title">说明</h3>
     <div class="methodsynopsis dc-description">
      <span class="type">bool</span> <span class="methodname"><strong>pg_trace</strong></span>
       ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$pathname</code></span>
      [, <span class="methodparam"><span class="type">string</span> <code class="parameter">$mode</code></span>
      [, <span class="methodparam"><span class="type">resource</span> <code class="parameter">$connection</code></span>
     ]] )</div>

    <p class="para rdfs-comment">
     <span class="function"><strong>pg_trace()</strong></span> 启动 PostgreSQL 前端／后端通讯的追踪并记录到 <em><code class="parameter">pathname</code></em> 指定的文件中。要完全理解结果，用户需要熟悉 PostgreSQL 通讯协议的本质。对不熟悉的用户来说，追踪发送到服务器的查询错误依然有用，例如可以用 <strong class="command">grep &#039;^To backend&#039; trace.log</strong> 来查看哪些查询实际上被发送到了 PostgreSQL 服务器。更多信息参考 PostgreSQL 手册。
    </p>
    <p class="para">
     参数 <em><code class="parameter">pathname</code></em> 和 <em><code class="parameter">mode</code></em> 和 <span class="function"><a href="function.fopen.html" class="function">fopen()</a></span>(<em><code class="parameter">mode</code></em> 默认为 &#039;w&#039;) 中的一样。<em><code class="parameter">connection</code></em> 指定了要追踪的连接，默认为上一个打开的连接。
    </p>
    <p class="para">
     如果 <em><code class="parameter">pathname</code></em> 可以作为日志文件打开，则
     <span class="function"><strong>pg_trace()</strong></span> 返回 <strong><code>TRUE</code></strong>，否则返回 <strong><code>FALSE</code></strong>。
    </p>
    <p class="para">
     参见 <span class="function"><a href="function.fopen.html" class="function">fopen()</a></span> 和 <span class="function"><a href="function.pg-untrace.html" class="function">pg_untrace()</a></span>。
    </p>
   </div>

  </div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.pg-set-error-verbosity.html">pg_set_error_verbosity</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.pg-transaction-status.html">pg_transaction_status</a></div>
 <div class="up"><a href="ref.pgsql.html">PostgreSQL 函数</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
